Xbasic

FILENAME_RELATIVE Function

Syntax

Relative_Filename as C = filename_relative(C filename [,C reference_path ])

Arguments

filename

A fully qualified filename with path.

reference_path

Optional. Default = path of current database. A path to use as a starting point in composing the relative filename.

Description

Converts a filename into a relative filename. If reference_path is blank, assume current database path.

FILENAME_RELATIVE() returns a character string after converting a fully qualified filename into an relative filename. In the following example, the database path is "C:\Databases\Functions".

Example

dim cs as C
cs = filename_relative("C:\Databases\upgrade.txt")
cs   ->   "\Databases\upgrade.txt"
tn = "c:\program files\a5v5\samples\alphasports\customer.dbf"
filename_relative(tn, "c:\windows") ->   "\program files\a5v5\samples\alphasports\customer.dbf"

See Also